home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / util / misc / ALockUtils.lha / Docs / ALockUtils.doc < prev    next >
Encoding:
Text File  |  1996-09-16  |  42.0 KB  |  2,445 lines
  1. 1.    ALockUtils
  2.  
  3.  
  4.                            ALockUtils Version 1.1
  5.  
  6.                                  15.09.1996
  7.  
  8.             Copyright © 1996 Janne Peräaho. All Rights Reserved.
  9.  
  10.  
  11.   Copyrights    Rights
  12.  
  13.   Introduction  What is this?
  14.   Requirements  What do I need?
  15.   Installation  How to install?
  16.   Commands      How to use?
  17.   Limitations   Weak points
  18.  
  19.   History       Done so far
  20.   Comments      Feedback
  21.   Future        To do
  22.  
  23.  
  24. 2.    Copyrights
  25.  
  26.  
  27.  ALockUtils Copyright © 1996 Janne Peräaho. All rights reserved.
  28.  
  29.  
  30.  ALockUtils IS INFOWARE. IF YOU REGULARY USE ANY OF THE ALockUtils TOOLS
  31.  YOU MUST INFORM ME ABOUT THAT. YOU DON'T HAVE TO PUT YOUR NAME AND
  32.  ADDRESS IN YOUR NOTE, JUST PLAIN TEXT "I use ALockUtils too!" WILL DO.
  33.  
  34.  YOU MAY FREELY COPY AND SPREAD ALockUtils AS LONG AS ALL PROGRAMS IN
  35.  ALockUtils PACKAGE REMAIN AN INTEGRATED WHOLE WHEN COPIED.
  36.  
  37.  BY SELLING OR ANY OTHER WAY OF GAINING FINANCIAL PROFIT AT THE COST OF
  38.  ALockUtils IS FORBID.
  39.  
  40.  
  41. 3.    Author
  42.  
  43.  
  44.  Please, send comments, bug observations, and development proposals to me:
  45.  
  46.   ____
  47.  |\  /| PAPER
  48.  | \/ | MAIL 
  49.  |____| abcdefgh
  50.  
  51.  Janne Peräaho
  52.  Tullimiehentie 3B19
  53.  90560 OULU 56
  54.  FINLAND
  55.  
  56.   ____
  57.  |\  /| ELECTRONIC
  58.  | \/ | MAIL
  59.  |____| 01010101
  60.  
  61.  Janne Peräaho
  62.  jake@rieska.oulu.fi
  63.  
  64.  
  65.   /\  HOME PAGE
  66.  /  \ _=___=___=_ 01010101
  67.  |[]|  |   |   |  10101010
  68.  
  69.  Janne Peräaho
  70.  http://www.student.oulu.fi/~jake/
  71.  
  72.  
  73. 4.    Introduction
  74.  
  75.  
  76.                            ALockUtils Version 1.1
  77.  
  78.                                 Introduction
  79.  
  80.  
  81.  ALockUtils is an independent security system and a collection of utilities
  82.  for ALock (Amiga security system by Trevor Andrews) at the same time.
  83.  
  84.  Each time you boot your Amiga, you will be asked your login ID and password.
  85.  When ID and password are valid, boot procedure will continue and the
  86.  ID, place (system name), date, and time of your login will be written into
  87.  a separate log file.
  88.  
  89.  With the help of ALock and/or ALockUtils you can easily monitor, who is
  90.  using your Amiga and when, and prevent unauthorized use of your Amiga
  91.  computer.
  92.  
  93.  ALockUtils brings you an opportunity to use several startup-sequences
  94.  and thus possibility of booting your Amiga with different setups.
  95.  (For example one setup for Workbench users, one setup for Bridgeboard
  96.  users, one setup for artists, one setup for game players, and so on.)
  97.  
  98.  ALockUtils contains also tools for controlling users, tools to get
  99.  information about users, tools for sending and receiving mails, and a
  100.  primitive drive protection system.
  101.  
  102.  
  103. 5.    Requirements
  104.  
  105.  
  106.                            ALockUtils Version 1.1
  107.  
  108.                                 Requirements
  109.  
  110.  
  111.                      CPU......... 68000 or better
  112.                      KICKSTART... Version 2.04 or later
  113.                      LIBRARIES... reqtools.library Version 38 or later
  114.                      PROGRAMS.... execute, lock, more
  115.  
  116.  Programs execute, lock, and more can be found from your WorkBench-disk.
  117.  Reqtools.library is not included.
  118.  
  119.  
  120. 6.    Installation
  121.  
  122.  
  123.                            ALockUtils Version 1.1
  124.  
  125.                                 Installation
  126.  
  127.  
  128.   ALockUtils-Install  How to install ALockUtils
  129.   ALock-Install       How to install ALock
  130.  
  131.  
  132. 7.    ALockUtils-Install
  133.  
  134.  
  135.                            ALockUtils Version 1.1
  136.  
  137.                      Installation  (files: ALock files)
  138.  
  139.  
  140.  ALock and ALockUtils are using the following files: "passwd", "finger.log",
  141.  and "motd". File "passwd" must always exists, "finger.log" is created
  142.  automaticly, and "motd" may omit.
  143.  
  144.  Copy the contents of directory "ETC" to your "ETC"-directory.
  145.  
  146.  
  147. 8.    ALock-Install
  148.  
  149.  
  150.                            ALockUtils Version 1.1
  151.  
  152.                      Installation  (files: ALock files)
  153.  
  154.  
  155.  ALock and ALockUtils are using the following files: "passwd", "finger.log",
  156.  and "motd". File "passwd" must always exists, "finger.log" is created
  157.  automaticly, and "motd" may omit.
  158.  
  159.  Copy the contents of directory "ETC" to your "ETC"-directory.
  160.  
  161.  
  162. 9.    ALockUtils manual installation
  163.  
  164.  
  165.                            ALockUtils Version 1.1
  166.  
  167.                      Installation  (files: ALock files)
  168.  
  169.  
  170.  ALock and ALockUtils are using the following files: "passwd", "finger.log",
  171.  and "motd". File "passwd" must always exists, "finger.log" is created
  172.  automaticly, and "motd" may omit.
  173.  
  174.  Copy the contents of directory "ETC" to your "ETC"-directory.
  175.  
  176.  
  177. 10.    Directories
  178.  
  179.  
  180.                            ALockUtils Version 1.1
  181.  
  182.                          Installation (directories)
  183.  
  184.  
  185.   ETC            ETC:
  186.   System's home  HOMES:
  187.   User's home    HOME:
  188.  
  189.  Directories for etc, system's home, and users' homes are needed.
  190.  
  191.  
  192. 11.    ETC
  193.  
  194.  
  195.                            ALockUtils Version 1.1
  196.  
  197.                       Installation  (directories: ETC)
  198.  
  199.  
  200.  This directory contains crucial files for ALock and ALockutils.
  201.  
  202.  Assign "ETC:" to this directory, before calling any ALock- or ALockUtils
  203.  commands.
  204.  
  205.  
  206. 12.    System's home
  207.  
  208.  
  209.                            ALockUtils Version 1.1
  210.  
  211.                   Installation (directories: System's home)
  212.  
  213.  
  214.  System should have an own directory, where all users' home directories,
  215.  lock files, and individual MOTD files are.
  216.  
  217.  Assign "HOMES:" to this directory, before calling any ALockUtils commands.
  218.  
  219.  
  220. 13.    User's home
  221.  
  222.  
  223.                            ALockUtils Version 1.1
  224.  
  225.                    Installation (directories: User's home)
  226.  
  227.  
  228.  Every user have an own home directory. Home directory is located at system's
  229.  home. Say we have user with user ID "jake" and system's home directory is 
  230.  located at "S:homes/". This user's home directory will therefore be
  231.  "S:homes/jake/".
  232.  
  233.  When user logs into a system (ALock & UserStartup and Login commands),
  234.  device "HOME:" is assigned to user's home directory.
  235.  
  236.  Use command HomeAdd to create new home directory.
  237.  
  238.  
  239. 14.    Files
  240.  
  241.  
  242.                            ALockUtils Version 1.1
  243.  
  244.                             Installation (files)
  245.  
  246.  
  247.   ALock files        How to install crucial files
  248.   Commands           How to install commands
  249.   Drive locks        How to install drive locks
  250.   Mailbox            How to install mailboxes
  251.   MOTDs              How to install MOTDs
  252.   Startup-sequences  How to install startup sequences
  253.  
  254.  ALock utilities assume that certain files exists. Like mailbox, drive lock,
  255.  startup,and motd files.
  256.  
  257.  
  258. 15.    ALock files
  259.  
  260.  
  261.                            ALockUtils Version 1.1
  262.  
  263.                      Installation  (files: ALock files)
  264.  
  265.  
  266.  ALock and ALockUtils are using the following files: "passwd", "finger.log",
  267.  and "motd". File "passwd" must always exists, "finger.log" is created
  268.  automaticly, and "motd" may omit.
  269.  
  270.  Copy the contents of directory "ETC" to your "ETC"-directory.
  271.  
  272.  
  273. 16.    Commands
  274.  
  275.  
  276.                            ALockUtils Version 1.1
  277.  
  278.                            Installation (commands)
  279.  
  280.  
  281.  ALockUtils directory C contains all ALockUtils commands. Copy those commands
  282.  somewhere along system's path.
  283.  
  284.  
  285. 17.    Drive locks
  286.  
  287.  
  288.                            ALockUtils Version 1.1
  289.  
  290.                          Installation (drive locks)
  291.  
  292.  
  293.  Superuser can write protect drives from users. In system's home directory
  294.  ("HOMES:") every user have an own lock file containing the name of the
  295.  drives which should be write protect when user logs in. Lock file name is
  296.  "lock.<id>", where <id> is the user login ID.
  297.  
  298.  Say we have an user with user ID "jake" and we want to lock drives DH1: and
  299.  DH2: from that user. All we need to do, is to create file "lock.jake" in
  300.  system's home ("HOMES:") directory and write two lines in that file:
  301.  
  302.    DH1:
  303.    DH2:
  304.  
  305.  and that's it!
  306.  Drives are locked when UserStartup command or Login command is
  307.  succesfully executed. Locking is not permanent. Either reboot or new login
  308.  (Login command) will release the locks.
  309.  
  310.  When home directory is created with HomeAdd command with option LOCKS,
  311.  empty lock file is created. After creating the lock file, use any text
  312.  editor to add drive names (which should be locked) in that file.
  313.  
  314.  
  315. 18.    Mailbox
  316.  
  317.  
  318.                            ALockUtils Version 1.1
  319.  
  320.                            Installation (mailbox)
  321.  
  322.  
  323.  Each user have an own mailbox. Mailbox is located at "HOME:mail/incoming".
  324.  Mailbox contains several mails which all have a same format:
  325.  
  326.    From: <id>@<host><LF>
  327.    Subject: <subject><LF>
  328.    To: <id> (<real_name>)<LF>
  329.    Date: <weekday> <month> <day> <hour>:<minutes>:<seconds> <year><LF>
  330.    <message><FF>
  331.  
  332.  where
  333.  
  334.  <id>
  335.  User ID
  336.  
  337.  <host>
  338.  Host name
  339.  
  340.  <subject>
  341.  Mail subject
  342.  
  343.  <real_name>
  344.  User real name
  345.  
  346.  <weekday>
  347.  Weekday (Mon, Tue, Wed...)
  348.  
  349.  <month>
  350.  Month (Jan, Feb, Mar...)
  351.  
  352.  <day>
  353.  Day (01-31)
  354.  
  355.  <hour>
  356.  Hour (00-23)
  357.  
  358.  <minutes>
  359.  Minutes (00-59)
  360.  
  361.  <seconds>
  362.  Seconds (00-59)
  363.  
  364.  <year>
  365.  Year (1-)
  366.  
  367.  <message>
  368.  Mail text
  369.  
  370.  <LF>
  371.  Line feed (ASCII value 10 ($0A))
  372.  
  373.  <FF>
  374.  Form feed (ASCII value 12 ($0C)). This serves as end of mail mark.
  375.  
  376.  
  377.  When home directory is created with HomeAdd command, mailbox is created
  378.  automaticly. Don't try to create mailbox by your self. Use command HomeAdd!
  379.  
  380.  
  381. 19.    MOTDs
  382.  
  383.  
  384.                            ALockUtils Version 1.1
  385.  
  386.                             Installation (MOTDs)
  387.  
  388.  
  389.  There are two kind of MOTD (Message Of ToDay) files: global and individuals.
  390.  Global MOTD is shown to everyone and individual MOTD is personal and
  391.  different for each user.
  392.  
  393.  ALock can show only global MOTD, but Login can show both.
  394.  
  395.  Global MOTD is located at "ETC:motd" and its a normal ASCII text file.
  396.  Individual MOTD files can be found from system's home ("HOMES:") with name
  397.  "motd.<id>", where <id> is user ID. An example of individual MOTD file:
  398.  
  399.    You are logged in as '286' - PC-Task user.
  400.    Other emulators available in this system:
  401.  
  402.    BridgeBoard   Login: 386   Password: 386
  403.    A64           Login: c64   Password: c64
  404.  
  405.  The length of individual MOTD file is not limited.
  406.  If MOTD file (global or individual) does not exists it's not been shown
  407.  either.
  408.  
  409.  When home directory is created with HomeAdd command with option MOTD,
  410.  empty MOTD file is created. Use any text editor to edit the "message of
  411.  today".
  412.  
  413.  
  414. 20.    Startup-sequences
  415.  
  416.  
  417.                            ALockUtils Version 1.1
  418.  
  419.                   Installation  (files: Startup-sequences)
  420.  
  421.  
  422.   Individual startup-sequences 
  423.   Original startup-sequence    
  424.   Shell-Startup                
  425.  
  426.  Installation to the original startup-sequence must be done. If you want
  427.  to use multiple startup-sequences installation of individual startup-
  428.  sequences is required.
  429.  
  430.  
  431. 21.    Individual startup-sequences
  432.  
  433.  
  434.                            ALockUtils Version 1.1
  435.  
  436.              Installation (files: Individual startup-sequences)
  437.  
  438.  
  439.  Each system user can have an own individual startup sequence. Individual
  440.  startup sequence is an AmigaDOS script file (like startup-sequence)
  441.  containing AmigaDOS commands.
  442.  
  443.  Startup file is located at user's home ("HOME:startup" = HOMES:<id>/startup)
  444.  directory. If you have low memory and want to use for example PC-Task PC
  445.  emulator (demo version, located at "DH1:Emulators/PC/PC-Task/"), create new
  446.  user with name "286" and write into his/her startup file the following
  447.  lines:
  448.  
  449.    ; This is an individual startup sequence for PC-Task users
  450.    DH1:Emulators/PC/PC-Task/PC-TaskDemo
  451.  
  452.  Every time user "286" logs in, only PC-Task emulator will be executed.
  453.  You save time and memory!
  454.  
  455.  NOTE! When command "Login" or "UserStartup" has ended and individual startup
  456.  sequence has been executed, the execution of original startup sequence will
  457.  continue. Therefore Login or UserStartup must be the last command in
  458.  original startup sequence.
  459.  
  460.  When home directory is created with HomeAdd command with option STARTUP,
  461.  empty startup file is created. Use any text editor to add AmigaDOS commands
  462.  in it.
  463.  
  464.  
  465. 22.    Original startup-sequence
  466.  
  467.  
  468.                            ALockUtils Version 1.1
  469.  
  470.                    Installation (files: Startup-sequence)
  471.  
  472.  
  473.  Edit file "S:Startup-Sequence" or "S:User-startup" and add line to execute
  474.  "Login"-command.
  475.  
  476.  "Login"-command needs certain environment variables to work properly. It
  477.  also sets new variables. Assigns to devices "ETC:" and "HOMES:" are also
  478.  needed.
  479.  
  480.  Creation of "ENV:" device and assigns to "ETC:" and "HOMES:" must therefore
  481.  occur before calling "Login". For example (S:Startup-Sequence):
  482.  
  483.    ...
  484.    C:MAKEDIR RAM:T RAM:CLIPBOARDS RAM:ENV RAM:ENV/SYS <--- ENV:
  485.    C:COPY >NIL: ENVARC: RAM:ENV ALL NOREQ             <--- ENV:
  486.    ASSIGN >NIL: ENV: RAM:ENV                          <--- ENV:
  487.    ...
  488.  
  489.    ;BEGIN ALockUtils
  490.    Assign ETC: SYS:ALock/etc                          <--- Assign ETC:
  491.    Assign HOMES: SYS:ALock/homes                      <--- Assign HOMES:
  492.    Login LOGIN="root" NOMENU                          <--- Call Login
  493.    ;END ALockUtils
  494.  
  495.    EndCLI >NIL:
  496.  
  497.  Installation script installs "Login"-command to the "S:User-Startup". You
  498.  can do the same by adding lines:
  499.  
  500.    ;BEGIN ALockUtils
  501.    Assign ETC: SYS:ALock/etc                          <--- Assign ETC:
  502.    Assign HOMES: SYS:ALock/homes                      <--- Assign HOMES:
  503.    Login LOGIN="root" NOMENU                          <--- Call Login
  504.    ;END ALockUtils
  505.  
  506.  to the end of "S:User-Startup"-file.
  507.  
  508.  
  509. 23.    Shell-Startup
  510.  
  511.  
  512.                            ALockUtils Version 1.1
  513.  
  514.                     Installation  (files: Shell-Startup)
  515.  
  516.  
  517.  When new shell is opened the contents of file "S:Shell-Startup" is executed.
  518.  If you want that your mailbox is checked each time you start new shell
  519.  process, edit "S:Shell-Startup" file and add there command:
  520.  
  521.   NewMail NOGUI
  522.  
  523.  
  524. 24.    Environment variables
  525.  
  526.  
  527.                            ALockUtils Version 1.1
  528.  
  529.                     Installation (environment variables)
  530.  
  531.  
  532.  The following environment variables are used:
  533.  
  534.  HostName  - user sets
  535.  Kickstart - system sets
  536.  UserID    - ALockPatch and Login sets
  537.  UserName  - ALock and Login sets
  538.  Workbench - system sets
  539.  
  540.  The only variable you must set is "HostName" all others are created
  541.  automaticly. Use command HostName to set "HostName".
  542.  
  543.  
  544. 25.    Commands
  545.  
  546.  
  547.                            ALockUtils Version 1.1
  548.  
  549.                                   Commands
  550.  
  551.  
  552.  All commands
  553.  
  554.   ALockPatch    Finger        FlushLog      HomeAdd     
  555.   HomeDel       HostName      Last          ListUsers   
  556.   Login         Mail          MailBox       NewMail     
  557.   Passwd        ReadMail      ReadMOTD      TrashMail   
  558.   UserAdd       UserDel       UserMod       UserStartup 
  559.   WhoAmI        WhoIs       
  560.  
  561.  Commands in groups
  562.  
  563.   Information   Loging in     Mailing       Misc        
  564.   Users       
  565.  
  566.  
  567. 26.    Information
  568.  
  569.  
  570.                            ALockUtils Version 1.1
  571.  
  572.                        Commands (information commands)
  573.  
  574.  
  575.   Finger      Hostname    Last        ListUsers   MailBox     NewMail   
  576.   WhoAmI      WhoIs       ReadMOTD  
  577.  
  578.  Commands for information.
  579.  
  580.  
  581. 27.    Loging in
  582.  
  583.  
  584.                            ALockUtils Version 1.1
  585.  
  586.                         Commands (loging in commands)
  587.  
  588.  
  589.   FlushLog      Last          Login         UserStartup 
  590.  
  591.  Commands for login procedure.
  592.  
  593.  
  594. 28.    Mailing
  595.  
  596.  
  597.                            ALockUtils Version 1.1
  598.  
  599.                          Commands (mailing commands)
  600.  
  601.  
  602.   Mail        MailBox     NewMail     ReadMail    TrashMail 
  603.  
  604.  Commands for mailing.
  605.  
  606.  
  607. 29.    Other commands
  608.  
  609.  
  610.                            ALockUtils Version 1.1
  611.  
  612.                           Commands (other commands)
  613.  
  614.  
  615.   AlockPatch   FlushLog     HostName   
  616.  
  617.  Miscellaneus commands.
  618.  
  619.  
  620. 30.    Users
  621.  
  622.  
  623.                            ALockUtils Version 1.1
  624.  
  625.                           Commands (user commands)
  626.  
  627.  
  628.   Finger        HomeAdd       HomeDel       Last          ListUsers   
  629.   UserAdd       UserDel       UserMod       Passwd        UserStartup 
  630.   WhoAmI        WhoIs       
  631.  
  632.  Commands connection to users.
  633.  
  634.  
  635. 31.    ALockPatch
  636.  
  637.  
  638.  NAME
  639.  
  640.    ALockPatch
  641.  
  642.  
  643.  REQUIREMENTS
  644.  
  645.    Devices:
  646.  
  647.    "ETC:"       - to read file passwd
  648.  
  649.  
  650.    Files:
  651.  
  652.    "ETC:passwd" - to get current user login ID
  653.  
  654.  
  655.    Environment variables
  656.  
  657.    "UserName"   - to get current user name
  658.  
  659.  
  660.  DESCRIPTION
  661.  
  662.    ALockPatch patches ALock security system by creating environment variable
  663.    "UserID". This variable contains current user's login ID.
  664.  
  665.    ALockPatch should be executed in startup-sequence just after ALock.
  666.    If several user have a same name (real name) it is uncertain if "UserID"
  667.    is set correctly.
  668.  
  669.  
  670.  ARGUMENTS
  671.  
  672.    ALockPatch
  673.  
  674.  
  675.  EXAMPLES
  676.  
  677.    ALockPatch
  678.  
  679.  
  680.  BUGS
  681.  
  682.    None known.
  683.  
  684.  
  685.  LOOK ALSO
  686.  
  687.    -
  688.  
  689.  
  690. 32.    Finger
  691.  
  692.  
  693.  NAME
  694.  
  695.    Finger
  696.  
  697.  
  698.  REQUIREMENTS
  699.  
  700.    Devices:
  701.  
  702.    "ETC:"           - to get contents of files "passwd" and "finger.log"
  703.  
  704.  
  705.    Files:
  706.  
  707.    "ETC:passwd"     - to get user real name
  708.    "ETC:finger.log" - to get last login
  709.  
  710.  
  711.    Environment variables:
  712.  
  713.    "UserID"         - to get current user login ID
  714.  
  715.  
  716.  DESCRIPTION
  717.  
  718.    Finger gives information about current user or any other user.
  719.  
  720.  
  721.  ARGUMENTS
  722.  
  723.    Finger ID
  724.  
  725.    ID
  726.    <login_id>
  727.    User's login ID you want to get information.
  728.  
  729.    Without any arguments Finger shows information about current user.
  730.  
  731.  
  732.  EXAMPLES
  733.  
  734.    Finger
  735.    Finger jake
  736.  
  737.  
  738.  BUGS
  739.  
  740.    None known.
  741.  
  742.  
  743.  LOOK ALSO
  744.  
  745.     ListUsers 
  746.     WhoAmI    
  747.     WhoIs     
  748.  
  749.  
  750. 33.    FlushLog
  751.  
  752.  
  753.  NAME
  754.  
  755.    FlushLog
  756.  
  757.  
  758.  REQUIREMENTS
  759.  
  760.    Devices:
  761.  
  762.    "ETC:"               - to read file finger.log
  763.  
  764.  
  765.    Files:
  766.  
  767.    "ETC:finger.log"     - to flush file "finger.log"
  768.  
  769.  
  770.    Environment variables:
  771.  
  772.    "UserID"             - to set new log size
  773.  
  774.  
  775.  DESCRIPTION
  776.  
  777.    FlushLog updates system's logfile.
  778.    This command should be executed in a startup-sequence after ALock.
  779.  
  780.    FlushLog uses preference file ("FlushLog.prefs") if present. Only
  781.    superuser can change preferences.
  782.  
  783.  
  784.  ARGUMENTS
  785.  
  786.    FlushLog SIZE/N
  787.  
  788.    SIZE
  789.    <int_number>
  790.    Sets new limit for login history. Option available only for superuser.
  791.  
  792.    Without any arguments FlushLog updates logfile ("ETC:finger.log") by
  793.    removing login information (starting from oldest), until only <logsize>
  794.    entries are left.
  795.  
  796.  
  797.  EXAMPLES
  798.  
  799.    FlushLog
  800.    FlushLog 10
  801.  
  802.  
  803.  BUGS
  804.  
  805.    None known.
  806.  
  807.  
  808.  LOOK ALSO
  809.  
  810.     Last  
  811.     Login 
  812.  
  813.  
  814. 34.    HomeAdd
  815.  
  816.  
  817.  NAME
  818.  
  819.    HomeAdd
  820.  
  821.  
  822.  REQUIREMENTS
  823.  
  824.    Devices:
  825.  
  826.    "ETC:"       - for passwd file
  827.  
  828.  
  829.    Files:
  830.  
  831.    "ETC:passwd" - to get target ID real name
  832.  
  833.  
  834.    Environment variables:
  835.  
  836.    "UserID"     - to get current user login ID
  837.    "HostName"   - to get system's name
  838.  
  839.  
  840.  DESCRIPTION
  841.  
  842.    Superuser command only.
  843.  
  844.    Create home directory for new user.
  845.  
  846.    User's home directory is named after his/her login ID. Device "HOME:" is
  847.    assigned to that directory (by commands Login or/and UserStartup) every
  848.    time user logs in.
  849.  
  850.    The following directories and files are created to the <system's_home>
  851.    (="HOMES:"):
  852.  
  853.    <id> (DIR)       Created always. Assigned to "HOME:".
  854.      mail (DIR)     Created always.
  855.        incoming     Created always. Contains greetings mail.
  856.      startup        Created when switch STARTUP is present. Is empty.
  857.    lock.<id>        Created when switch LOCKS is present. Is empty.
  858.    motd.<id>        Created when switch MOTD is present. Is empty.
  859.  
  860.    <id> is the login ID of given user.
  861.  
  862.  
  863.  ARGUMENTS
  864.  
  865.    HomeAdd P=PATH/K,ID,STARTUP/S,LOCKS/S,MOTD/S
  866.  
  867.    PATH
  868.    <path>
  869.    Path to the system's home (users' home directories are stored here).
  870.    Default is "HOMES:".
  871.  
  872.    ID
  873.    <login_id>
  874.    User ID
  875.  
  876.    STARTUP
  877.    Create default startup file.
  878.  
  879.    LOCKS
  880.    Create empty lock file.
  881.  
  882.    MOTD
  883.    Create individual default "message of to day" file.
  884.  
  885.  
  886.  EXAMPLES
  887.  
  888.    HomeAdd jake
  889.    HomeAdd jake STARTUP
  890.    HomeAdd jake STARTUP LOCKS
  891.    HomeAdd jake STARTUP MOTD
  892.    HomeAdd S: jake STARTUP LOCKS MOTD
  893.    HomeAdd S: jake STARTUP
  894.    HomeAdd S: jake
  895.  
  896.  
  897.  BUGS
  898.  
  899.    None known.
  900.  
  901.  
  902.  LOOK ALSO
  903.  
  904.     HomeDel 
  905.     UserAdd 
  906.  
  907.  
  908. 35.    HomeDel
  909.  
  910.  
  911.  NAME
  912.  
  913.    HomeDel
  914.  
  915.  
  916.  REQUIREMENTS
  917.  
  918.    Environment variables:
  919.  
  920.    "UserID" - to get current user login ID
  921.  
  922.  
  923.  DESCRIPTION
  924.  
  925.    Superuser command only.
  926.  
  927.    Removes home directory of given user.
  928.  
  929.    The following directories and files are removed from <system's_home>
  930.    (="HOMES:"):
  931.  
  932.    <id> (DIR)
  933.      mail (DIR)
  934.        incoming
  935.      startup
  936.    lock.<id>
  937.    motd.<id>
  938.  
  939.    <id> is the login ID of given user.
  940.  
  941.  
  942.  ARGUMENTS
  943.  
  944.    HomeDel P=PATH/K/A,ID/A
  945.  
  946.    PATH
  947.    <path>
  948.    Path to the system's home (users' home directories are stored here).
  949.    Default is "HOMES:".
  950.  
  951.    ID
  952.    <login_id>
  953.    User ID
  954.  
  955.  
  956.  EXAMPLES
  957.  
  958.    HomeDel jake
  959.    HomeDel S: jake
  960.  
  961.  
  962.  BUGS
  963.  
  964.    None known.
  965.  
  966.  
  967.  LOOK ALSO
  968.  
  969.     HomeAdd 
  970.     UserDel 
  971.  
  972.  
  973. 36.    HostName
  974.  
  975.  
  976.  NAME
  977.  
  978.    HostName
  979.  
  980.  
  981.  REQUIREMENTS
  982.  
  983.    Evironment variables:
  984.  
  985.    "UserID"   - to get current user login ID
  986.    "HostName" - to get system's name
  987.  
  988.  
  989.  DESCRIPTION
  990.  
  991.    Show or set computer's name.
  992.  
  993.  
  994.  ARGUMENTS
  995.  
  996.    HostName HOST
  997.  
  998.    HOST - New name for your Amiga. Option available only for superuser.
  999.  
  1000.    Without arguments HostName shows computer's name.
  1001.  
  1002.  
  1003.  EXAMPLES
  1004.  
  1005.    HostName
  1006.    HostName Amiga2000
  1007.  
  1008.  
  1009.  BUGS
  1010.  
  1011.    None known.
  1012.  
  1013.  
  1014.  LOOK ALSO
  1015.  
  1016.    -
  1017.  
  1018.  
  1019. 37.    Last
  1020.  
  1021.  
  1022.  NAME
  1023.  
  1024.    Last
  1025.  
  1026.  
  1027.  REQUIREMENTS
  1028.  
  1029.    Devices:
  1030.  
  1031.    "ETC:"           - to read file "finger.log"
  1032.  
  1033.  
  1034.    Files:
  1035.  
  1036.    "ETC:finger.log" - to get last login information
  1037.  
  1038.  
  1039.  DESCRIPTION
  1040.  
  1041.    Show user's last login information.
  1042.  
  1043.  
  1044.  ARGUMENTS
  1045.  
  1046.    Last ID
  1047.  
  1048.    ID
  1049.    <login_id>
  1050.    User's ID for login information.
  1051.  
  1052.    Without argument Last shows every user's login information.
  1053.  
  1054.  
  1055.  EXAMPLES
  1056.  
  1057.    Last
  1058.    Last jake
  1059.  
  1060.  
  1061.  BUGS
  1062.  
  1063.    None known.
  1064.  
  1065.  
  1066.  LOOK ALSO
  1067.  
  1068.     FlushLog 
  1069.     Login    
  1070.  
  1071.  
  1072. 38.    ListUsers
  1073.  
  1074.  
  1075.  NAME
  1076.  
  1077.    ListUsers
  1078.  
  1079.  
  1080.  REQUIREMENTS
  1081.  
  1082.    Devices:
  1083.  
  1084.    "ETC:"       - to read file "passwd"
  1085.  
  1086.  
  1087.    Files:
  1088.  
  1089.    "ETC:passwd" - to list users
  1090.  
  1091.  
  1092.  DESCRIPTION
  1093.  
  1094.    List system's users.
  1095.  
  1096.    Output:
  1097.      <user_id>1 <user_real_name>1
  1098.      <user_id>2 <user_real_name>2
  1099.      <user_id>3 <user_real_name>3
  1100.      ...
  1101.      <user_id>n <user_real_name>n
  1102.  
  1103.      System have <number_of_users> users.
  1104.  
  1105.    where
  1106.  
  1107.    <user_id>
  1108.    User ID
  1109.  
  1110.    <user_real_name>
  1111.    The real name of user
  1112.  
  1113.    <number_of_users>
  1114.    Total number of system's users
  1115.  
  1116.  
  1117.  ARGUMENTS
  1118.  
  1119.    ListUsers
  1120.  
  1121.  
  1122.  EXAMPLES
  1123.  
  1124.    ListUsers
  1125.  
  1126.  BUGS
  1127.  
  1128.    None known.
  1129.  
  1130.  
  1131.  LOOK ALSO
  1132.  
  1133.     Finger  
  1134.     Last    
  1135.     Mail    
  1136.     UserAdd 
  1137.     UserDel 
  1138.     UserMod 
  1139.     WhoIs   
  1140.  
  1141.  
  1142. 39.    Login
  1143.  
  1144.  
  1145.  NAME
  1146.  
  1147.    Login
  1148.  
  1149.  
  1150.  REQUIREMENTS
  1151.  
  1152.    Devices:
  1153.    
  1154.    "ETC:"           - for files passwd and finger.log
  1155.    "HOMES:"         - to find and set user home
  1156.  
  1157.    
  1158.    Files:
  1159.    
  1160.    "ETC:passwd"     - to log in (user ID's and passwords are stored here)
  1161.    "ETC:finger.log" - to get last login and to save current login place,
  1162.                       date, and time
  1163.  
  1164.    
  1165.    Commands:
  1166.  
  1167.    "alock"          - for ALock login
  1168.    "alockpatch"     - for ALock login
  1169.    "flushlog"       - to flush log file
  1170.    "lock"           - to lock and unlock drives
  1171.    "newmail"        - to check mailbox contents
  1172.    "passwd"         - to change password
  1173.    "readmotd"       - to read MOTDs
  1174.    "userstartup"    - to execute user's startup sequence
  1175.  
  1176.  
  1177.    Environment variables:
  1178.  
  1179.    "Kickstart"      - to get kickstart version number
  1180.    "Workbench"      - to get workbench version number
  1181.    "HostName"       - to get system's name
  1182.  
  1183.  
  1184.  DESCRIPTION
  1185.  
  1186.    Login logs into a system.
  1187.  
  1188.    Login can be executed from Shell or Workbench. Both cases Login will
  1189.    open an own screen to read login ID and password. After successful
  1190.    login procedure, main menu will be opened (if NOMENU option was not
  1191.    present).
  1192.  
  1193.    Login uses preference file ("Login.prefs") if present. Only superuser
  1194.    can change preferences.
  1195.  
  1196.  
  1197.  ARGUMENTS
  1198.  
  1199.    Login A=ALOCK/K,E=SECURITY/K,F=FONTS/K,L=LOGIN/K,P=PASSWORD/K,
  1200.          R=RETRIES/N/K,S=SCREEN/K,NOBEEP/S,NOMENU/S
  1201.  
  1202.    CLI arguments and WorkBench tooltypes:
  1203.  
  1204.    ALOCK
  1205.    <alock_arguments>
  1206.    If any arguments are given, login will use ALock to log in.
  1207.    Arguments given here will be passed to the ALock command.
  1208.    Example: ALOCK=""
  1209.  
  1210.    SECURITY
  1211.    <hex_value>
  1212.    This argument controls Login security level. Default = 0.
  1213.    -----------------------------------------------
  1214.     Control bit   Purpose
  1215.    -----------------------------------------------
  1216.          0        Disable/enable ALock loging
  1217.          1        Disable/enable default login ID
  1218.          2        Disable/enable default password
  1219.    -----------------------------------------------
  1220.    When bit is set, option is disabled.
  1221.    Example: SECURITY="7"
  1222.  
  1223.    FONTS
  1224.    <name>,<size>
  1225.    Set fonts to be used in login procedure.
  1226.    <name> = font name with extension .font
  1227.    <size> = font size
  1228.    Example: FONTS="ruby.font,13"
  1229.  
  1230.    LOGIN
  1231.    <id>
  1232.    Set default login ID.
  1233.    Example: LOGIN="root"
  1234.  
  1235.    PASSWORD
  1236.    <password>
  1237.    Set default password.
  1238.    Example: PASSWORD="6qsiPuu"
  1239.  
  1240.    RETRIES
  1241.    <int_value>
  1242.    Set maximum number of login retries. When maximum retries limit is
  1243.    reached, Login will perform coldreboot. Default = 0 = no limit.
  1244.    Example: RETRIES=0
  1245.  
  1246.    SCREEN
  1247.    <hex_value>
  1248.    Set screenmode to use. Default = 08000.
  1249.    ------------------------------------
  1250.     Value   Screenmode
  1251.    ------------------------------------
  1252.     00000   Lores
  1253.     00004   Lores-Interlaced
  1254.     08000   Hires
  1255.     08004   Hires-Interlaced
  1256.     08020   SuperHires
  1257.     08024   SuperHires-Interlaced
  1258.     11000   NTSC:Lores
  1259.     11004   NTSC:Lores-Interlaced
  1260.     19000 = NTSC:Hires
  1261.     19004 = NTSC:Hires-Interlaced
  1262.     19020 = NTSC:SuperHires
  1263.     19024 = NTSC:SuperHires-Interlaced
  1264.     21000 = PAL:Lores
  1265.     21004 = PAL:Lores-Interlaced
  1266.     29000 = PAL:Hires
  1267.     29004 = PAL:Hires-Interlaced
  1268.     29020 = PAL:SuperHires
  1269.     29024 = PAL:SuperHires-Interlaced
  1270.     31004 = VGA-ExtraLores
  1271.     31005 = VGA-ExtraLores-Interlaced
  1272.     39004 = VGA-Lores
  1273.     39005 = VGA-Lores-Interlaced
  1274.     39024 = Productivity
  1275.     39025 = Productivity-Interlaced
  1276.     41000 = A2024_10Hz
  1277.     49000 = A2024_15Hz
  1278.    ------------------------------------
  1279.    Example: SCREEN="08024"
  1280.  
  1281.    NOBEEP
  1282.    Do not flash screen when false login attempt occures.
  1283.    Example: NOBEEP
  1284.  
  1285.    NOMENU
  1286.    Do not open login menu.
  1287.    Example: NOMENU
  1288.  
  1289.  
  1290.  EXAMPLES
  1291.  
  1292.    Login
  1293.    Login >NIL:
  1294.    Login NOMENU SECURITY=7 RETRIES=5
  1295.  
  1296.  
  1297.  BUGS
  1298.  
  1299.    None known.
  1300.  
  1301.  
  1302.  LOOK ALSO
  1303.  
  1304.     FlushLog    
  1305.     Last        
  1306.     Passwd      
  1307.     ReadMOTD    
  1308.     UserStartup 
  1309.  
  1310.  
  1311. 40.    Main menu
  1312.  
  1313.  
  1314.  Exit from Login.
  1315.  
  1316.  
  1317. 41.    Relogin
  1318.  
  1319.  
  1320.  Exit from Login.
  1321.  
  1322.  
  1323. 42.    Change password
  1324.  
  1325.  
  1326.  Exit from Login.
  1327.  
  1328.  
  1329. 43.    Exit
  1330.  
  1331.  
  1332.  Exit from Login.
  1333.  
  1334.  
  1335. 44.    Options menu
  1336.  
  1337.  
  1338.  
  1339.                                    OPTIONS
  1340.  
  1341.                    ______________________________________
  1342.                   |                                      |
  1343.                   |   @| Enabled  Mailbox check          |
  1344.                   |                                      |
  1345.                   |   @| Enabled  Show MOTD              |
  1346.                   |                                      |
  1347.                   |   @| Enabled  Show Individual MOTD   |
  1348.                   |                                      |
  1349.                   |   @| Enabled  Flush log              |
  1350.                   |                                      |
  1351.                   |   @| Enabled  Update log             |
  1352.                   |                                      |
  1353.                   |   @| Enabled  User startup           |
  1354.                   |______________________________________|
  1355.  
  1356.                        Save         Use       Cancel 
  1357.  
  1358.  
  1359.  Mailbox check
  1360.  Enable/disable mailbox check.
  1361.  
  1362.  Show MOTD
  1363.  Enable/disable viewing of "Message Of Today".
  1364.  
  1365.  Show Individual MOTD
  1366.  Enable/disable viewing of "Individual Message Of Today".
  1367.  
  1368.  Flush log
  1369.  Enable/disable log flushing. This option is for superuser (root) only.
  1370.  
  1371.  Update log
  1372.  Enable/disable log update. This option is for superuser (root) only.
  1373.  
  1374.  User startup
  1375.  Enable/disable user startup. This option is for superuser (root) only.
  1376.  
  1377.  Save
  1378.  Save options and exit to the main menu. This operation is allowed for
  1379.  superuser (root) only.
  1380.  
  1381.  Use
  1382.  Use these options and exit to the main menu.
  1383.  
  1384.  Cancel
  1385.  Undo changes and exit to the main menu.
  1386.  
  1387.  
  1388. 45.    Mail
  1389.  
  1390.  
  1391.  NAME
  1392.  
  1393.    Mail
  1394.  
  1395.  
  1396.  REQUIREMENTS
  1397.  
  1398.    Devices:
  1399.  
  1400.    "ETC:"       - to read file "passwd"
  1401.  
  1402.  
  1403.    Files:
  1404.  
  1405.    "ETC:passwd" - to send mail
  1406.  
  1407.  
  1408.    Environment variables:
  1409.  
  1410.    "UserID"     - to send mail
  1411.    "HostName"   - to send mail
  1412.  
  1413.  
  1414.  DESCRIPTION
  1415.  
  1416.    Send mail. Before sending mail, you have to write it by using some text
  1417.    editor and save it somewhere. After that you can send the mail.
  1418.  
  1419.  
  1420.  ARGUMENTS
  1421.  
  1422.    Mail SUBJECT/A,FILE/A,ID/A
  1423.  
  1424.    SUBJECT
  1425.    <mail_subject>
  1426.    Mail subject
  1427.  
  1428.    FILE
  1429.    <mail_file>
  1430.    Mail file name
  1431.  
  1432.    ID
  1433.    <login_id>
  1434.    Receiver's ID
  1435.  
  1436.  
  1437.  EXAMPLES
  1438.  
  1439.    Mail Hello ram:mail.txt jake
  1440.  
  1441.  
  1442.  BUGS
  1443.  
  1444.    None known.
  1445.  
  1446.  
  1447.  LOOK ALSO
  1448.  
  1449.     ListUsers 
  1450.     MailBox   
  1451.     NewMail   
  1452.     ReadMail  
  1453.     TrashMail 
  1454.  
  1455.  
  1456. 46.    MailBox
  1457.  
  1458.  
  1459.  NAME
  1460.  
  1461.    MailBox
  1462.  
  1463.  
  1464.  REQUIREMENTS
  1465.  
  1466.    Devices:
  1467.  
  1468.    "HOME:"              - to list mails
  1469.  
  1470.  
  1471.    Files:
  1472.  
  1473.    "HOME:mail/incoming" - to list mails
  1474.  
  1475.  
  1476.  DESCRIPTION
  1477.  
  1478.    List mailbox contents.
  1479.  
  1480.    If any keywords are given, MailBox will list only those messages which
  1481.    include any of the given keywords. (Keyword search is case sensitive.)
  1482.  
  1483.    Output:
  1484.      <message_number>1   <mmm>1 <dd>1 <sender>1 <length>1   <subject>1 
  1485.      <message_number>2   <mmm>2 <dd>2 <sender>2 <length>2   <subject>2 
  1486.      <message_number>3   <mmm>3 <dd>3 <sender>3 <length>3   <subject>3 
  1487.      ...
  1488.      <message_number>n   <mmm>n <dd>n <sender>n <length>n   <subject>n 
  1489.  
  1490.    where
  1491.  
  1492.    <message_number>
  1493.    Message number
  1494.  
  1495.    <mmm>
  1496.    Month
  1497.  
  1498.    <dd>
  1499.    Day
  1500.  
  1501.    <sender>
  1502.    Sender user ID
  1503.  
  1504.    <length>
  1505.    Mail length in bytes
  1506.  
  1507.    <subject>
  1508.    Subject
  1509.  
  1510.  
  1511.  ARGUMENTS
  1512.  
  1513.    MailBox M=MAILBOX/K,KEYWORDS/M
  1514.  
  1515.    MAILBOX
  1516.    <mailbox>
  1517.    Name of the mailbox (default is "HOME:mail/incoming")
  1518.  
  1519.    KEYWORDS
  1520.    <keyword_1> <keyword_2>... <keyword_n>
  1521.    List only messages including some or all of the keywords
  1522.  
  1523.  
  1524.  EXAMPLES
  1525.  
  1526.    MailBox
  1527.    MailBox greetings hello hi
  1528.    MailBox MAILBOX=HOME:mail/incoming amiga Amiga AMIGA
  1529.  
  1530.  
  1531.  BUGS
  1532.  
  1533.    None known.
  1534.  
  1535.  LOOK ALSO
  1536.  
  1537.     Mail      
  1538.     NewMail   
  1539.     ReadMail  
  1540.     TrashMail 
  1541.  
  1542.  
  1543. 47.    NewMail
  1544.  
  1545.  
  1546.  NAME
  1547.  
  1548.    NewMail
  1549.  
  1550.  
  1551.  REQUIREMENTS
  1552.  
  1553.    Devices:
  1554.  
  1555.    "HOME:"              - to check mailbox
  1556.  
  1557.  
  1558.    Files:
  1559.  
  1560.    "HOME:mail/incoming" - to check mailbox
  1561.  
  1562.  
  1563.    Libraries:
  1564.  
  1565.    reqtools.library     - for requester
  1566.  
  1567.  
  1568.  DESCRIPTION
  1569.  
  1570.    Check if user have received new mail.
  1571.  
  1572.    If mail exists the screen will flash and message "You have <n> mails."
  1573.    will appear (requester), where <n> is number of mails found. If option
  1574.    NOGUI exists, information is displayed in CLI window instead of
  1575.    requester.
  1576.  
  1577.    Ideal place for this command is in "Shell-startup".
  1578.  
  1579.  
  1580.  ARGUMENTS
  1581.  
  1582.    NewMail M=MAILBOX/K,NOBEEP/S,NOGUI/S
  1583.  
  1584.    MAILBOX
  1585.    <mailbox>
  1586.    The name of the mailbox (default is "HOME:mail/incoming")
  1587.  
  1588.    NOBEEP
  1589.    Do not flash screen when you have received mail.
  1590.  
  1591.    NOGUI
  1592.    Do not use requester to show number of mails received.
  1593.  
  1594.  
  1595.  EXAMPLES
  1596.  
  1597.    NewMail
  1598.    NewMail NOBEEP
  1599.    NewMail NOGUI
  1600.    NewMail MAILBOX="RAM:mail/incoming" NOBEEP NOGUI
  1601.  
  1602.  
  1603.  BUGS
  1604.  
  1605.    None known.
  1606.  
  1607.  
  1608.  LOOK ALSO
  1609.  
  1610.     Mail      
  1611.     MailBox   
  1612.     ReadMail  
  1613.     TrashMail 
  1614.  
  1615.  
  1616. 48.    Passwd
  1617.  
  1618.  
  1619.  NAME
  1620.  
  1621.    Passwd
  1622.  
  1623.  
  1624.  REQUIREMENTS
  1625.  
  1626.    Devices:
  1627.  
  1628.    "ETC:"       - to read file "passwd"
  1629.  
  1630.  
  1631.    Files:
  1632.  
  1633.    "ETC:passwd" - to change password
  1634.  
  1635.  
  1636.    Environment variables:
  1637.  
  1638.    "UserID"     - to get current user login ID
  1639.  
  1640.  
  1641.  DESCRIPTION
  1642.  
  1643.    Change current user password.
  1644.  
  1645.    Passwd can be executed from CLI or Workbench. Both cases an own screen
  1646.    will be opened to ask current user password and new password. The
  1647.    following gadgets will appear:
  1648.                    __________
  1649.          Password |__________|    =   current password
  1650.                    __________
  1651.      New password |__________|    =   new password
  1652.                    __________
  1653.            Verify |__________|    =   new password again for verifying
  1654.  
  1655.    By default new password must contain at least 6 characters and commas
  1656.    are not allowed as a password characters.
  1657.  
  1658.    Passwd uses preference file ("Passwd.prefs") if present. Only superuser
  1659.    can change preferences (-> PASSWDLEN).
  1660.  
  1661.  
  1662.  ARGUMENTS
  1663.  
  1664.    Passwd F=FONTS/K,P=PASSWDLEN/N/K,R=RETRIES/N/K,S=SCREEN/K,NOBEEP/S
  1665.  
  1666.    CLI arguments and WorkBench tooltypes:
  1667.  
  1668.    FONTS
  1669.    <name>,<size>
  1670.    Set fonts to be used.
  1671.    <name> = font name with extension .font
  1672.    <size> = font size
  1673.    Example: FONTS="ruby.font,13"
  1674.  
  1675.    PASSWDLEN
  1676.    <int_value>
  1677.    Set minimum length of new password. This option is for superuser (root)
  1678.    only.
  1679.  
  1680.    RETRIES
  1681.    <int_value>
  1682.    Set maximum number of password retries. When maximum retries limit is
  1683.    reached, Passwd will exit. Default = 6. Value 0 = unlimited retries.
  1684.    Example: RETRIES=3
  1685.  
  1686.    SCREEN
  1687.    <hex_value>
  1688.    Set screenmode to use. Default = 08000.
  1689.    ------------------------------------
  1690.     Value   Screenmode
  1691.    ------------------------------------
  1692.     00000   Lores
  1693.     00004   Lores-Interlaced
  1694.     08000   Hires
  1695.     08004   Hires-Interlaced
  1696.     08020   SuperHires
  1697.     08024   SuperHires-Interlaced
  1698.     11000   NTSC:Lores
  1699.     11004   NTSC:Lores-Interlaced
  1700.     19000 = NTSC:Hires
  1701.     19004 = NTSC:Hires-Interlaced
  1702.     19020 = NTSC:SuperHires
  1703.     19024 = NTSC:SuperHires-Interlaced
  1704.     21000 = PAL:Lores
  1705.     21004 = PAL:Lores-Interlaced
  1706.     29000 = PAL:Hires
  1707.     29004 = PAL:Hires-Interlaced
  1708.     29020 = PAL:SuperHires
  1709.     29024 = PAL:SuperHires-Interlaced
  1710.     31004 = VGA-ExtraLores
  1711.     31005 = VGA-ExtraLores-Interlaced
  1712.     39004 = VGA-Lores
  1713.     39005 = VGA-Lores-Interlaced
  1714.     39024 = Productivity
  1715.     39025 = Productivity-Interlaced
  1716.     41000 = A2024_10Hz
  1717.     49000 = A2024_15Hz
  1718.    ------------------------------------
  1719.         Example: SCREEN=08024
  1720.  
  1721.    NOBEEP
  1722.    Do not flash screen when false password occures.
  1723.    Example: NOBEEP
  1724.  
  1725.  
  1726.  EXAMPLES
  1727.  
  1728.    Passwd
  1729.    Passwd FONTS="ruby.font,13" NOBEEP
  1730.  
  1731.  
  1732.  BUGS
  1733.  
  1734.    None known.
  1735.  
  1736.  
  1737.  LOOK ALSO
  1738.  
  1739.     Login   
  1740.     UserMod 
  1741.  
  1742.  
  1743. 49.    ReadMail
  1744.  
  1745.  
  1746.  NAME
  1747.  
  1748.    ReadMail
  1749.  
  1750.  
  1751.  REQUIREMENTS
  1752.  
  1753.    Devices:
  1754.  
  1755.    "HOME:"              - to read mail
  1756.  
  1757.  
  1758.    Files:
  1759.  
  1760.    "HOME:mail/incoming" - to read mail
  1761.  
  1762.  
  1763.  DESCRIPTION
  1764.  
  1765.    Extract new mail to the standard output.
  1766.  
  1767.    Mail number 0 is equal to the last mail number.
  1768.  
  1769.    Output:
  1770.      From: <userid>@<hostname>
  1771.      Subject: <subject>
  1772.      To: <userid> (<username>)
  1773.      Date: <weekday> <month> <day> <hour>:<minute>:<second> <year>
  1774.  
  1775.      <message>
  1776.  
  1777.    or (when NOHEADER-option present)
  1778.      <message>
  1779.  
  1780.   
  1781.  ARGUMENTS
  1782.  
  1783.    ReadMail M=MAILBOX/K,MAIL/N/A,NOHEADER/S
  1784.  
  1785.    MAILBOX
  1786.    <mailbox>
  1787.    Name of the mailbox (default is "incoming")
  1788.  
  1789.    MAIL
  1790.    <int_value>
  1791.    Mail number
  1792.  
  1793.    NOHEADER
  1794.    Do not show mail header
  1795.  
  1796.  
  1797.  EXAMPLES
  1798.  
  1799.    ReadMail 1
  1800.    ReadMail 1 NOHEADER
  1801.    ReadMail MAILBOX=home:mail/incoming 0
  1802.    ReadMail >RAM:last.txt 0 NOHEADER
  1803.  
  1804.  
  1805.  BUGS
  1806.  
  1807.    None known.
  1808.  
  1809.  
  1810.  LOOK ALSO
  1811.  
  1812.     Mail      
  1813.     MailBox   
  1814.     NewMail   
  1815.     ReadMOTD  
  1816.     TrashMail 
  1817.  
  1818.  
  1819. 50.    ReadMOTD
  1820.  
  1821.  
  1822.  NAME
  1823.  
  1824.    ReadMOTD
  1825.  
  1826.  
  1827.  REQUIREMENTS
  1828.  
  1829.    Devices:
  1830.  
  1831.    "ETC:"      - to read message of today
  1832.    "HOMES"     - to read individual message of today
  1833.  
  1834.  
  1835.    Commands:
  1836.  
  1837.    "run"       - when using default viewer
  1838.    "more"      - when using default viewer
  1839.  
  1840.  
  1841.    Files:
  1842.  
  1843.    "motd"      - to view the contents of "message of today"-file
  1844.    "motd.<id>" - to view the contents of "individual message of today"-file
  1845.  
  1846.  
  1847.  DESCRIPTION
  1848.  
  1849.    ReadMOTD will show the contents of "message of today"-files. Without
  1850.    any arguments the general MOTD-file will be shown ("ETC:motd"). Argument
  1851.    INDIVIDUAL will cause ReadMOTD to show the contents of "individual
  1852.    message of today"-file ("HOMES:motd.<id>").
  1853.  
  1854.    ReadMOTD doesn't have an own internal viewer, it always use external
  1855.    viewer to show file contents. By default external viewer is "more".
  1856.  
  1857.    Instead of text files ReadMOTD can show for example pictures, animations,
  1858.    and play samples. This can be done by giving correct player to the
  1859.    ReadMOTD.
  1860.  
  1861.  
  1862.  ARGUMENTS
  1863.  
  1864.    ReadMOTD VIEWER,INDIVIDUAL/S
  1865.  
  1866.    VIEWER
  1867.    <command>
  1868.    Command-line for for external viewer. Default is "run more %s".
  1869.    Template "%s" is replaced with correct file name ("motd" or "motd.<id>").
  1870.    
  1871.  
  1872.    INDIVIDUAL
  1873.    Read individual message of today
  1874.  
  1875.  
  1876.  EXAMPLES
  1877.  
  1878.    ReadMOTD
  1879.    ReadMOTD INDIVIDUAL
  1880.    ReadMOTD VIEWER="run >NIL: multiview SCREEN %s"
  1881.  
  1882.  
  1883.  BUGS
  1884.  
  1885.    None known.
  1886.  
  1887.  
  1888.  LOOK ALSO
  1889.  
  1890.     Login    
  1891.     ReadMail 
  1892.  
  1893.  
  1894. 51.    TrashMail
  1895.  
  1896.  
  1897.  NAME
  1898.  
  1899.    TrashMail
  1900.  
  1901.  
  1902.  REQUIREMENTS
  1903.  
  1904.    Devices:
  1905.  
  1906.    "HOME:"              - to trash mail
  1907.  
  1908.  
  1909.    Files:
  1910.  
  1911.    "HOME:mail/incoming" - to trash mail
  1912.  
  1913.  
  1914.  DESCRIPTION
  1915.  
  1916.    Trash mail.
  1917.  
  1918.    Mail number 0 is equal to the last mail number.
  1919.  
  1920.  
  1921.  ARGUMENTS
  1922.  
  1923.    TrashMail M=MAILBOX/K,MAIL/N/M/A
  1924.  
  1925.    MAILBOX
  1926.    <mailbox>
  1927.    Name of the mailbox (default is "home:mail/incoming")
  1928.  
  1929.    MAIL
  1930.    <int_value_1> <int_value_2>... <int_value_n>
  1931.    Mail number(s) to be removed
  1932.  
  1933.  
  1934.  EXAMPLES
  1935.  
  1936.    TrashMail 1
  1937.    TrashMail 1 3 4 7
  1938.    TrashMail MAILBOX=home:mail/incoming 0
  1939.  
  1940.  
  1941.  BUGS
  1942.  
  1943.    None known.
  1944.  
  1945.  
  1946.  LOOK ALSO
  1947.  
  1948.     Mail     
  1949.     MailBox  
  1950.     NewMail  
  1951.     ReadMail 
  1952.  
  1953.  
  1954. 52.    UserAdd
  1955.  
  1956.  
  1957.  NAME
  1958.  
  1959.    UserAdd
  1960.  
  1961.  
  1962.  REQUIREMENTS
  1963.  
  1964.    Devices:
  1965.  
  1966.    "ETC:"       - to get file "passwd"
  1967.  
  1968.  
  1969.    Files:
  1970.  
  1971.    "ETC:passwd" - to add new user
  1972.  
  1973.  
  1974.    Environment variables:
  1975.  
  1976.    "UserID"     - to get current user login ID
  1977.  
  1978.  
  1979.  DESCRIPTION
  1980.  
  1981.    Superuser command only.
  1982.  
  1983.    Create new user. Use command "HomeAdd" the create home directory for
  1984.    new user.
  1985.  
  1986.  
  1987.  ARGUMENTS
  1988.  
  1989.    UserAdd I=ID/K,N=NAME/K,P=PASSWORD/K
  1990.  
  1991.    ID
  1992.    <login_id>
  1993.    User unique identification name.
  1994.  
  1995.    NAME
  1996.    <name>
  1997.    User's real name.
  1998.  
  1999.    PASSWORD
  2000.    <password>
  2001.    Password for new user.
  2002.  
  2003.  
  2004.  EXAMPLES
  2005.  
  2006.    UserAdd ID=jake PASSWORD="12345678" NAME="Janne Peräaho"
  2007.  
  2008.  
  2009.  BUGS
  2010.  
  2011.    None known.
  2012.  
  2013.  
  2014.  LOOK ALSO
  2015.  
  2016.     HomeAdd   
  2017.     ListUsers 
  2018.     UserDel   
  2019.     UserMod   
  2020.  
  2021.  
  2022. 53.    UserDel
  2023.  
  2024.  
  2025.  NAME
  2026.  
  2027.    UserDel
  2028.  
  2029.  
  2030.  REQUIREMENTS
  2031.  
  2032.    Devices:
  2033.  
  2034.    "ETC:"       - to get file "passwd"
  2035.  
  2036.  
  2037.    Files:
  2038.  
  2039.    "ETC:passwd" - to delete user
  2040.  
  2041.  
  2042.    Environment variables:
  2043.  
  2044.    "UserID"     - to get current user login ID
  2045.  
  2046.  
  2047.  DESCRIPTION
  2048.  
  2049.    Superuser command only.
  2050.  
  2051.    UserDel removes user from host computer. Use command "HomeDel" to remove
  2052.    user's home directory.
  2053.  
  2054.  
  2055.  ARGUMENTS
  2056.  
  2057.    UserDel ID/A
  2058.  
  2059.    ID
  2060.    <login_id>
  2061.    User's ID which you want to remove.
  2062.  
  2063.  
  2064.  EXAMPLES
  2065.  
  2066.    UserDel jake
  2067.  
  2068.  
  2069.  BUGS
  2070.  
  2071.    None known.
  2072.  
  2073.  
  2074.  LOOK ALSO
  2075.  
  2076.     HomeDel   
  2077.     ListUsers 
  2078.     UserAdd   
  2079.     UserMod   
  2080.  
  2081.  
  2082. 54.    UserMod
  2083.  
  2084.  
  2085.  NAME
  2086.  
  2087.    UserMod
  2088.  
  2089.  
  2090.  REQUIREMENTS
  2091.  
  2092.    Devices:
  2093.  
  2094.    "ETC:"       - to get file "passwd"
  2095.  
  2096.  
  2097.    Files:
  2098.  
  2099.    "ETC:passwd" - to modify user
  2100.  
  2101.  
  2102.    Environment variables:
  2103.  
  2104.    "UserID"     - to get current user login ID
  2105.  
  2106.  
  2107.  DESCRIPTION
  2108.  
  2109.    Superuser command only.
  2110.  
  2111.    Modify user information.
  2112.  
  2113.  
  2114.  ARGUMENTS
  2115.  
  2116.    UserMod I=ID/K,D=NEWID/K,N=NAME/K,P=PASSWORD/K
  2117.  
  2118.    ID
  2119.    <login_id>
  2120.    User's ID which userinformation you want to modify.
  2121.  
  2122.    NEWID
  2123.    <login_id>
  2124.    New user identification name.
  2125.  
  2126.    NAME
  2127.    <name>
  2128.    New real name for user.
  2129.  
  2130.    PASSWORD
  2131.    <password>
  2132.    New password for user.
  2133.  
  2134.  
  2135.  EXAMPLES
  2136.  
  2137.    UserMod ID=jake NEWID=jake PASSWORD="12345678" NAME="Janne Peräaho"
  2138.  
  2139.  
  2140.  BUGS
  2141.  
  2142.    None known.
  2143.  
  2144.  
  2145.  LOOK ALSO
  2146.  
  2147.     ListUsers 
  2148.     UserAdd   
  2149.     UserDel   
  2150.  
  2151.  
  2152. 55.    UserStartup
  2153.  
  2154.  
  2155.  NAME
  2156.  
  2157.    UserStartup
  2158.  
  2159.  
  2160.  REQUIREMENTS
  2161.  
  2162.    Devices:
  2163.  
  2164.    "ETC:"       - for file passwd
  2165.    "HOMES:"     - for locking and executing startup
  2166.  
  2167.  
  2168.    Files:
  2169.  
  2170.    "ETC:passwd" - to check current user login ID
  2171.  
  2172.  
  2173.    Environment variables:
  2174.  
  2175.    "UserID"     - to assign home directory and to execute correct startup
  2176.                   sequence
  2177.  
  2178.  
  2179.    Commands:
  2180.    
  2181.    "lock"       - to lock drives
  2182.    "execute"    - to execute startup sequence
  2183.  
  2184.  
  2185.  DESCRIPTION
  2186.  
  2187.    With "UserStartup" it's possible to add individual startup-sequences for
  2188.    each system user.
  2189.  
  2190.    Individual startup sequence can be found from user's home directory:
  2191.    "HOME:startup" = "HOMES:<id>/startup" = "<system's_home>/<id>/startup".
  2192.  
  2193.    Device "HOMES:" should be assigned before executing UserStartup. If it's
  2194.    not assigned, path to the system's home is required.
  2195.  
  2196.    UserStartup try always assign device "HOME:" to "HOMES:<id>" or
  2197.    "<path>/<id>", where <id> is current user login ID and <path> is path to
  2198.    the system's home.
  2199.  
  2200.    It is also possible to lock drives from certain users by adding a file
  2201.    named after user's login ID in system's home ("HOMES:lock.<id>"). This
  2202.    file contains the names of the drives which should be write protect for
  2203.    this user.
  2204.  
  2205.    Each drive name have it's own line in that file. Locking is not
  2206.    permanent. Either reboot or new login will release the locks.
  2207.  
  2208.  
  2209.  ARGUMENTS
  2210.  
  2211.    UserStartup PATH
  2212.  
  2213.    PATH
  2214.    <path>
  2215.    Path to the system's home.
  2216.  
  2217.  
  2218.  EXAMPLES
  2219.  
  2220.    UserStartup
  2221.    UserStartup HOMES:
  2222.    UserStartup S:
  2223.  
  2224.  
  2225.  BUGS
  2226.  
  2227.    None known.
  2228.  
  2229.  
  2230.  LOOK ALSO
  2231.  
  2232.     Login 
  2233.  
  2234.  
  2235. 56.    WhoAmI
  2236.  
  2237.  
  2238.  NAME
  2239.  
  2240.    WhoAmI
  2241.  
  2242.  
  2243.  REQUIREMENTS
  2244.  
  2245.    Environment variables:
  2246.  
  2247.    "UserID" - to get current user login ID
  2248.  
  2249.  
  2250.  DESCRIPTION
  2251.  
  2252.    Show current user's identification name.
  2253.  
  2254.  
  2255.  ARGUMENTS
  2256.  
  2257.    WhoAmI
  2258.  
  2259.  
  2260.  EXAMPLES
  2261.  
  2262.    WhoAmI
  2263.  
  2264.  
  2265.  BUGS
  2266.  
  2267.    None known.
  2268.  
  2269.  
  2270.  LOOK ALSO
  2271.  
  2272.     Finger    
  2273.     ListUsers 
  2274.     WhoIs     
  2275.  
  2276.  
  2277. 57.    WhoIs
  2278.  
  2279.  
  2280.  NAME
  2281.  
  2282.    WhoIs
  2283.  
  2284.  
  2285.  REQUIREMENTS
  2286.  
  2287.    Devices:
  2288.  
  2289.    "ETC:"       - to read file "passwd"
  2290.  
  2291.  
  2292.    Files:
  2293.  
  2294.    "ETC:passwd" - to get information about given user
  2295.  
  2296.  
  2297.  DESCRIPTION
  2298.  
  2299.    Show user's real name.
  2300.  
  2301.  
  2302.  ARGUMENTS
  2303.  
  2304.    WhoIs ID/A
  2305.  
  2306.    ID
  2307.    <login_id>
  2308.    User's ID which real name you want to know.
  2309.  
  2310.  
  2311.  EXAMPLES
  2312.  
  2313.    WhoIs jake
  2314.  
  2315.  
  2316.  BUGS
  2317.  
  2318.    None known.
  2319.  
  2320.  
  2321.  LOOK ALSO
  2322.  
  2323.     Finger    
  2324.     ListUsers 
  2325.     WhoAmI    
  2326.  
  2327.  
  2328. 58.    Limitations
  2329.  
  2330.  
  2331.                            ALockUtils Version 1.1
  2332.  
  2333.                                  Limitations
  2334.  
  2335.  
  2336.  Security gained through ALock is far from perfect, but it offers excellent
  2337.  basic security solutions for average users.
  2338.  
  2339.  Main weak points are unprotected password file and OS's ability to prevent
  2340.  startup-sequence execution when required.
  2341.  
  2342.  With ALockUtils communication between users is possible by using individual
  2343.  mailbox files. However, these mailboxes are not protected from other users.
  2344.  Anyone have access to everyones mailboxes.
  2345.  
  2346.  Password- and mailbox file problems can be solved by using cryptographic
  2347.  procedures, but I am not willing to carry out file encoding and decoding
  2348.  qualities without users request.
  2349.  
  2350.  
  2351. 59.    History
  2352.  
  2353.  
  2354.                            ALockUtils Version 1.1
  2355.  
  2356.                                    History
  2357.  
  2358. 09.05.1996
  2359.  
  2360.   ALockUtils version 1.0. First release.
  2361.  
  2362. 15.09.1996
  2363.  
  2364.   ALockUtils version 1.1. Second release.
  2365.  
  2366.   NEW
  2367.  
  2368.   - Login can now fully replace ALock
  2369.   - install scripts for ALock and ALockUtils
  2370.   - Login
  2371.     + GUI
  2372.     + ability to change password
  2373.     + login options
  2374.     + default ID and password
  2375.     + security levels
  2376.     + ALock logging
  2377.     + user defined number of retries
  2378.     + preference file
  2379.   - command ReadMOTD
  2380.   - UserStartup
  2381.     + default path to the system's home
  2382.  
  2383.   BUG FIXES
  2384.  
  2385.   - Login
  2386.     + bug in "last login"-procedure (gave first login) fixed
  2387.     + security problem (command-line buffer) in CLI login fixed
  2388.   - Finger
  2389.     + bug in "last login"-procedure (gave first login) fixed
  2390.  
  2391.  
  2392. 60.    Comments
  2393.  
  2394.  
  2395.                            ALockUtils Version 1.1
  2396.  
  2397.                                   Comments
  2398.  
  2399.  
  2400.   ______
  2401.  |     |\
  2402.  | ~~~  ¯|
  2403.  | ~~~ ~ |
  2404.  | ~ ~~~ |
  2405.  | ~~ ~  |
  2406.  | ~ ~ ~ |
  2407.   ¯¯¯¯¯¯¯
  2408.    COMMENTS
  2409.  
  2410.    28.04.96 Jon Peterson
  2411.      Janne, great work supporting other authors with add-ons.
  2412.  
  2413.  
  2414. 61.    Future
  2415.  
  2416.  
  2417.                            ALockUtils Version 1.1
  2418.  
  2419.                                    Future
  2420.  
  2421.  
  2422.   .   .
  2423.  _ \_/ _
  2424.   \(_)/
  2425.  -=(_)=-
  2426.  _/(_)\_
  2427.  
  2428.    BUG OBSERVATIONS
  2429.  
  2430.  
  2431.   _____
  2432.  |_____\      ____ ____
  2433.    | |     __|____|____
  2434.    | |   _|____|____|__
  2435.    |_|  |____|____|____|
  2436.  
  2437.    DEVELOPMENT PROPOSALS
  2438.  
  2439.    09.05.96 Janne Peräaho
  2440.      GUIs for receiving and sending mails, adding, modifying, and deleting
  2441.      users
  2442.  
  2443.    15.09.96 Janne Peräaho
  2444.      Preference file for command ReadMOTD
  2445.